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Overview 
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o Scriptable system for defining “visual 
effects” 


o Effect can be composed of particle systems, 
decals, sounds(!), sequences, more 


o Scripts are live: the game or viewer 
updates as soon as you hit save. 


o There is no UI beyond that 


In Action: SimCity 4 
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o Shipped with SimCity 4 
o Atmospheric effects: weather, clouds 


o UI! Terrain rings, cursor effects, dust 
clouds on building plop, coverage rings 


o Fire, boats/planes, building destruction 


o Every single disaster was an effect 


In Action: Sims 2 
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o 3 dedicated effects artists, plus others. 
o 39,000 lines of scripts as of now 


o Sim and Object effects (cockroaches, 
spray, fire, splashes, alien abduction) 


o UI (thought balloons, build mode 
cursors) 


o Camera scripting 


Particles 
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o Standard textured 
quads 


o “Curves” 
o Forces, collision 


o Various emitter 
shapes 


o Stretch: cheap blur 


Decals 


TT de la Oe 


o Terrain- 
attached 


o Freely 
rotatable, 
sizeable, 


stretchable a = 


Others! 
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oA visual effect is a collection of component 
effects. These include particles, decals, 
framebuffer effects, sequences, etc. 


o Each component can be individually placed 
and oriented inside the visual effect. 


o Visual effects are also components: nesting 


o Particle systems whose particles are effects 


Game-specific Components 
Bean hee eT ae niga aor casdaieebiclacihiow 
o Terrain brushes 
o Automata attractors 
o Pause and unpause Simulator 
o Grab and manipulate camera 
o Pool water 


o Game messages 


Effect Examples 
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o Meteor: Decal, model, particles, brush, 
shake 

o Plop: Ring decals, dust particles, text 

_ particle, shake 


Scripting Language 
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o Very simple command-based scripting 
system. 


o Inspired by scripts used in animation 
production (R&H, CMU). 


o Easy to add options and new commands. 


Inheritance 
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o You can inherit from almost any description 


o This allows reuse of existing components 
with slight tweaks to colour curves or 
forces. 


Documentation 
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o Essential. 


o Picked a particular layout for documenting 
commands and stuck with it. 


o Maintained by the engineer and kept in 
sync with the script. 


o Used third party editor (SciTE) with 
support for syntax highlighting and folds. 
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oShows colour curve: almost any variable 
can be specified as a curve. 


particles lod?estaase 
life 1 
rate 30 
source -point 
emit -dir (0, 0, 1) 0-1 -speed 3 
texture “effec 

end 


particles lodTestRed : lodTestBase 
color (1, 0, 0) 

end 

particles lodvestGreen : lodvestBase 
color (0, 1, 0) 

end 

particles lodvestBlue : lodvestBase 
color (0, 0, 1) 

end 


effect lodrest -noautostop 


Simple Fountain 


Variants 


particlerffect lodTestRed -lodRange 1 2 -sizeScale 2 1 


particleEffect lodTestalue -lod 4 
particlerffect lodrestcreen -lod 5 
end 


Triggering Effects 
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o Permanently attached to bone 
o Attached to cursor 

o Triggered from Edith 

o Animation Events (Maya) 


o Triggered from code 


if (TS::EFFectsManager()->CreateVisualEFFect("nhood_fly”, mFlythroughEFFect. AsPPTypeParam())) 
{ 

cTSEFfectsTransform 3 

SetTransfornForTerrainCenter(t); 


pF lythroughCaneraEFFect->SetSourceTransForm(t) 
pF lythroughCaneraE FFect->Start() 


void nTSSG::cCaneratfFectsSuppart::StopFlythroughCaneraEFFect() 
{ 


‘if (mpFlythroughCameraEffect) 
impFlythroughCaneraEFFect->Stop(cITSVisual Effect: :klardTransition); 
pF lythroughCaneraEFFect = 0; 


struct cNumberCoemand : public tMyCommand 
t 
// The name of this comand. Lines of the form “number . 
11 this coomand. 
virtual const RZChar* NameC) const 
{return “numer”; } 


// the Execute method gets called for every occurrence of this command 
// in the script. If the coomand has associated state, it's available 
// through wState. The parser is available through mParser; it can 

// be used for parsing expressions (math allowed) or Looking up 

// variables. 


virtual void ExecuteCcIArguments* args) 
t 


// we're expecting one main argument. The args class will report 
// the appropriate error if there's not exactly on argument. 
‘tArgStrings va = args->NonSwitchArguments(1); 
nState->mCurrentData.nNunber = mParser->ParseFLoatExpression(va[0]) 


1 Yook for a switch -repeat with one argument. 
AF (va = args->SwitchArgunentsC*repeat”, 1D) 
nState->nCurrentData.mCount = mParser->ParseIntExpression(va[0]); 


‘enum tFloatParanType 
t 
kParantnitStrength, t scales the emit velocity 
kParankateScale, scales emit rate 


kParanTargetPoint, world space position 


kParamkttractorLocation, position 
kParanAttractorIntensity, intensity, 


kParaniviewkay, position & direction 
i 


‘enum, tUnknownParanType 
{ 


kParanMessagebata, U1< Wakonn: data for any messages sent. 
kParaniTransforeiiode, //7< TiransforeNode: transform node to attach this effect to. 


+ 


virtual bool SetVectorParans(tFloatParaniType id, const ¢TSVector3* params, int count = 1) = 
virtual bool SetFloatParans (tFloatParaniType id, const Float32* params, int count = 1) = 
virtual bool SetUnknownParan(tUnknownParaniType id, cIGZUnknown* param) = 

///< Used For passing data into an effect from code. Returns true if the data wos handled. 


Scaling 
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o Level of Detail 


o Discrete LODs at which components are 
switched on or off 


o Variable scaling between these of certain 
parameters: particle emit rate, size 


o All camera-distance based 


Scaling 
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o Priority (platform scaling) 


o Several different versions of the same 
effect authored: best match picked. 


o Limits 


o Suppress emission if particle limit 
reached (damping) 


o Clamp particle screen size. 


Architecture 
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o Scripts are all parsed into description 
blocks. There is no live script logic. 


o Each component has its own class, driven 
by a description, and associated commands 
which construct that description. 


o The effects manager controls effect 
instantiation, script reload, LOD changes, 
parameters, etc. 


Source/Effect 
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o Hard/Soft transitions 


o Hard prerolls the effect, or kills all 
outstanding particles/decals 
immediately. 


o Soft just starts or stops emitters 
o Source/Effect space 


o Can set both independently 


Advantages 
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o Gives artists direct entry into the game 


o Not just throwing art over the wall to 
engineers 


o Immediately viewable in-game 


o Has worked well even for non-technical 
artists 


o Fast feedback loop between artist/engineer 


Quick Prototyping 
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o We ended up (ab)using system to reach 
some goals we otherwise wouldn't have, 
given time constraints. 


o All SC4 boats, including shore avoidance 


0 All planes and plane paths: takeoff and 
landing. 


o Disasters (Volcano/Edith) 


Quick Prototyping (2) 
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o On Sims 2: Camera moves in danger of 
getting cut. So, various attempts at camera 
moves made using effect system. 


© MEL script written by a technically adept 
artist to translate Maya path into an effect. 


o Now have some extremely ambitious 
flythroughs going on, various in-game 
moves 


Disadvantages 
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o Need better monitoring and debugging 
facilities 


o Too easy for a (script) error in one effect to 
cascade to others 


o Need to keep a tight reign on development 


Acknowledgements 


ACNE tacit ea rom esecerytets this EMER REE nN tnt MLA seen stra esePati Bila 


Bais 


o Ocean Quigley 
o SC4: Christian Stratton, 
David Patch 


o TS2: Steve Kody, Kevin 
Byall, Don Livingston, Sam 
Yip 


